'\" t
.TH cm2_intro 1 "14 May 2008" "Code Manager II"

.SH NAME
cm2 \- Generic command interface to Code Manager II (cm2)

.SH SYNOPSIS
.TS
l l.
cm2 info	[\fB--verbose\fP] [\fB--long\fP] [\fB--versions\fP \fIA[,..]\fP] [\fB--xml\fP] file ...
.TE

.SH DESCRIPTION
The \fIcm2(1)\fP utility provides a single command to interface to all the underlying
commands that make up the complete Code Manager II toolkit. Developers are encouraged
to use this command in prefernce to the underlying commands since some UNIX environments
currently have name clashes [for example \fIstatus(1)\fP is already a standard command
name in certain Linux configurations].

If the command is run without arguments a summary of all supported sub-commands will
be shown. Each command can consist of one or more words - and aliases or alternatives
are also supported.

.SH ARGUMENTS
The arguments supported by each of the sub-commands must be given after the sub-command. 
Typically entering the following should produce a short help message for the command in
question.

.TS
l.
cm2 commandname -?
.TE

.SH EXIT CODES
All \fIcm2(1)\fP commands will issue a return code of 0 for success, or 1 or more
for an error. In must cases additional error text will be written to standard error
if a fatal error occurs. 

If a warning occurs [but no errors] the return code of the command will be 0 for success.

.SH NOTES
CM2 supports two different back-end repository versions - "1" or "2". The first version
does not support binary files on all architectures and requires RCS binaries to be 
available in the current PATH. Version 2 is preferred - it uses SQLite to store data, and
efficiently handles binary files. Further version 2 is much faster for most operations.

.SH AUTHOR
The \fBCode Manager II\fP tool set was written by Simon Edwards, Proprius Consulting Ltd, (\fBwww.proprius.co.uk\fP).

.SH SEE ALSO
.BR cm2_admin(1),
.BR cm2_checkin(1),
.BR cm2_cmpprojects(1),
.BR cm2_cmpreleases(1),
.BR cm2_info(1),
.BR cm2_listreleases(1),
.BR cm2_mci(1),
.BR cm2_mco(1),
.BR cm2_mdiff(1),
.BR cm2_mget(1),
.BR cm2_munlock(1),
.BR cm2_prarchive(1),
.BR cm2_rollback(1),
.BR cm2_status(1),
.BR cm2_tagrelease(1),
.BR cm2_tagremove(1),
.BR cm2_updated(1).

.SH AVAILABILITY
This utility was specifically written under the GNU GPL license and as required
by such software comes with \fIno warranty or guarantee of any kind\fP.

